Date class

Доступность

Flash Player 5.

Описание

Класс Date позволяет получить глобальные (по Гринвичу или UTC) или текущие (системные) дату и время, определяемые операционной системой, на которой запущен Flash Player. Методы класса Date не статичные и применяются отдельно для каждого экземпляра класса Date, для которого были вызваны, кроме метода Date.UTC() , он статичный.

В зависимости от операционной системы и версии Flash Player'а, класс Date по разному обрабатывает "летнее" время. Как это делается Flash Player'ом 6 и более поздними версиями в следующих операционных системах:

Windows— Date class автоматически учитывает и корректирует "летнее" время. Date class определяет, используется ли "летнее" время в текущем регионе и если да, то он вносит необходимую стандартную поправку. Однако текущие даты переходов едины и применяются и к прошлым и к будущим, что может вызвать ошибку в вычислении прошлых дат, если этот регион использовал иные даты переходов.
Mac OS X— объект Date автоматически учитывает и корректирует "летнее" время. Для этого в Mac OS X используется системная информационная база данных часовых поясов.
Mac X— Date class автоматически вносит поправку на летнее время. База данных по часовым поясам в Mac OS Х используется для того, чтобы определить в какую сторону должна быть сделана поправка.

Mac OS 9—операционная система представляет достаточно информации для того, чтобы определить, был ли совершен переход на летнее время. Соответствнно, если date object вносит поправку во все даты и время в прошлом и будущем.

Flash Player 5 обрабатывает переход на летнее время таким образом:

американские правила для перехода на летнее время применяются всегда, что приводит к неправильному переводу в Европе и других районах где переход на летнее время используется, но часовые пояса не совпадают с американскими. Флэш правильно определяет, используется ли переход на летнее время в текущей зоне.
Для вызова методов Date class, необходимо сначала создать обьект Date при помощи конструктора Date class, как это описано ниже.

Сводная таблица методов Date Class

Method	Description
`Date.getDate()`	Возвращает день месяца по системному времени.
`Date.getDay()`	Возвращает день недели по системному времени.
`Date.getFullYear()`	Возвращает четырехзначное значение года по системному времени.
`Date.getHours()`	Возвращает час по системному времени.
`Date.getMilliseconds()`	Возвращает количество миллисекунд по системному времени.
`Date.getMinutes()`	Возвращает количество минут по системному времени.
`Date.getMonth()`	Возвращает месяц по системному времени.
`Date.getSeconds()`	Возвращает количество секунд по системному времени.
`Date.getTime()`	Возвращает количество миллисекунд, прошедших с 1 января 1970 по глобальному времени.
`Date.getTimezoneOffset()`	Возвращает разницу в минутах между системным и глобальным временем.
`Date.getUTCDate()`	Возвращает день месяца по глобальному времени.
`Date.getUTCDay()`	Возвращает день недели по глобальному времени.
`Date.getUTCFullYear()`	Возвращает четырехзначное значение года по глобальному времени.
`Date.getUTCHours()`	Возвращает час по глобальному времени.
`Date.getUTCMilliseconds()`	Возвращает количество миллисекунд по глобальному времени.
`Date.getUTCMinutes()`	Возвращает количество минут по глобальному времени.
`Date.getUTCMonth()`	Возвращает месяц по глобальному времени.
`Date.getUTCSeconds()`	Возвращает количество секунд по глобальному времени.
`Date.getYear()`	Возвращает значение года по системному времени.
`Date.setDate()`	Выставляет день месяца по системному времени. Возвращает новое время в миллисекундах.
`Date.setFullYear()`	Выставляет полный год по системному времени. Возвращает новое время в миллисекундах.
`Date.setHours()`	Выставляет час по системному времени. Возвращает новое время в миллисекундах.
`Date.setMilliseconds()`	Выставляет количество миллисекунд по системному времени. Возвращает новое время в миллисекундах.
`Date.setMinutes()`	Выставляет количество минут по системному времени. Возвращает новое время в миллисекундах.
`Date.setMonth()`	Выставляет месяц по системному времени. Возвращает новое время в миллисекундах.
`Date.setSeconds()`	Выставляет количество секунд по системному времени. Возвращает новое время в миллисекундах.
`Date.setTime()`	Выставляет дату в миллисекундах. Возвращает новое время в миллисекундах.
`Date.setUTCDate()`	Выставляет дату по глобальному времени. Возвращает новое время в миллисекундах.
`Date.setUTCFullYear()`	Выставляет год по глобальному времени. Возвращает новое время в миллисекундах
`Date.setUTCHours()`	Выставляет час по глобальному времени. Возвращает новое время в миллисекундах
`Date.setUTCMilliseconds()`	Выставляет миллисекунды по глобальному времени. Возвращает новое время в миллисекундах.
`Date.setUTCMinutes()`	Выставляет минуты по глобальному времени. Возвращает новое время в миллисекундах.
`Date.setUTCMonth()`	Выставляет месяц по глобальному времени. Возвращает новое время в миллисекундах.
`Date.setUTCSeconds()`	Выставляет секунды по глобальному времени. Возвращает новое время в миллисекундах.
`Date.setYear()`	Выставляет год по системному времени.
`Date.toString()`	Возвращает строку, представляющую дату и время, содержащиеся в объекте Date.
`Date.UTC()`	Возвращает количество миллисекунд, прошедших с 00.00 1 января 1970 г. по глобальному времени до заданного времени.

Конструктор Date class

Доступность

Flash Player 5.

Синтаксис

new Date() : Date
new Date(timeValue:Number) : Date
new Date(year:Number, month:Number [, date:Number [, hour:Number [, minute:Number [, second:Number [, millisecond:Number ]]]]]) : Date

Параметры

year Число от 0 до 99, задающих год между 1900 и 1999, иначе должны быть заданы все четыре цифры. .

month Целое число от 0 (январь) до 11 (декабрь).

date Целое число от 1 до 31. Необязательный параметр.

hour Целое число от 0 (полночь) to 23 (11 вечера).

minute Целое число от 0 до 59. Необязательный параметр.

second Целое число от 0 до 59. Необязательный параметр.

millisecond Целое число от 0 до 999. Необязательный параметр.

Возвращает

Ссылка на объект Date.

Описание

Конструктор, создает новый объект Date, содержащий определенную дату или текущие дату и время.

Пример

Следующий пример показывает, как получить текущую дату и время:

var now_date:Date = new Date();

Следующий пример показывает, как создать новый объект Date, хранящий дату рожденья Мэри, 12 августа 1974 года (поскольку отсчет месяцев начинается с нуля, в примере используется 7 месяц а не 8)

var maryBirthday:Date = new Date (74, 7, 12);

Следующий пример создает новый объект Date и объеденяет возвращаемые значения Date.getMonth(), Date.getDate(), и Date.getFullYear():

var today_date:Date = new Date();
var date_str:String = ((today_date.getMonth()+1)+"/"+today_date.getDate()+"/"+today_date.getFullYear());
trace(date_str); // показывает текущую дату в формате, принятом в США.

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление